package com.booksystem.service;

import com.booksystem.common.RestResult;
import com.booksystem.dto.AddToCartDTO;
import com.booksystem.dto.CartUpdateQuantityDTO;
import com.booksystem.dto.CheckoutCartDTO;
import com.booksystem.dto.GetCartListDTO;
import com.booksystem.entity.ShoppingCartDO;
import java.util.List;

/**
 * <p>
 *   购物车业务逻辑接口
 * </p>
 * @author 段伟豪
 */
public interface ShoppingCartService {

    /**
     * 添加商品到购物车
     *
     * @param addToCartDTO 添加购物车参数
     * @return RestResult结果
     */
    RestResult<Boolean> addToCart(AddToCartDTO addToCartDTO);

    /**
     * 修改购物车商品数量
     *
     * @param cartUpdateQuantityDTO 更新购物车参数
     * @return RestResult结果
     */
    RestResult<Boolean> updateCartQuantity(CartUpdateQuantityDTO cartUpdateQuantityDTO);

    /**
     * 删除购物车商品
     *
     * @param cartId 购物车记录ID
     * @return RestResult结果
     */
    RestResult<Boolean> deleteCartItem(Long cartId);

    /**
     * 获取用户购物车列表
     *
     * @param getCartListDTO 查询参数
     * @return RestResult结果
     */
    RestResult<List<ShoppingCartDO>> getCartList(GetCartListDTO getCartListDTO);

    /**
     * 结算购物车商品
     *
     * @param checkoutCartDTO 结算参数
     * @return RestResult结果
     */
    RestResult<Boolean> checkoutCart(CheckoutCartDTO checkoutCartDTO);
}